home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / imprint.z / imprint
Text File  |  1998-10-30  |  21KB  |  397 lines
  1.  
  2.  
  3.  
  4. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      imprint - converts text files to PostScript, similar to Adobe
  10.      enscript(tm)
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      iiiimmmmpppprrrriiiinnnntttt [----1111] [----2222] [----BBBB] [----bbbb headerText]
  14.              [----cccc] [----dddd printerName] [----FFFF hfontNameSize]
  15.              [----ffff fontNameSize] [----GGGG] [----gggg] [----hhhh]
  16.              [----LLLL maxLines] [----llll] [----mmmm] [----nnnn numCopies]
  17.              [----oooo printerOptions] [----pppp outFilename] [----qqqq]
  18.              [----rrrr] [----RRRR] [----tttt bannerTitle] [----wwww]
  19.              [text file ...]
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _i_m_p_r_i_n_t formats text files using the PostScript page description language
  23.      and prints these files on a PostScript capable printer.  The program
  24.      provides a wide variety of formatting options including multiple column
  25.      output, page rotation, font selection and page decoration.
  26.  
  27.    TTTTeeeexxxxtttt FFFFiiiilllleeee IIIInnnnppppuuuutttt
  28.      One or more text files can be specified on the command line. If no files
  29.      are specified on the command line, _i_m_p_r_i_n_t will read from the standard
  30.      input. Currently, _i_m_p_r_i_n_t can accept plain text files in a number of
  31.      languages. The program has successfully formatted English, French,
  32.      German, and Russian (cyrillic) text files and theoretically should be
  33.      able to handle any language that can be expressed using an Adobe Type 1
  34.      font in a horizontal writing direction.  _i_m_p_r_i_n_t cannot currently handle
  35.      Adobe Type 0 composite fonts or vertical writing directions.
  36.  
  37.      Besides plain text files, _i_m_p_r_i_n_t can accept text files that contain
  38.      formatting control characters and special escape sequences. The most
  39.      common example of such files are formatted _n_r_o_f_f manual pages.  _i_m_p_r_i_n_t
  40.      has successfully handled the complex formatting produced by the _t_b_l and
  41.      _e_q_n programs. The following control characters and escape sequences are
  42.      recognized by _i_m_p_r_i_n_t:
  43.  
  44.              NNNNaaaammmmeeee        CCCChhhhaaaarrrr   CCCCooooddddeeee   DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  45.              _________________________________________________________
  46.              Null               0x00   No action
  47.              Bell        ^G     0x07   Audible bell
  48.              Backspace   ^H     0x08   Reverse one character
  49.              H Tab       ^I     0x09   Forward to next multiple of 8
  50.              Newline     ^J     0x0A   Start new line
  51.              V Tab       ^K     0x0B   Down one line
  52.              Formfeed    ^L     0x0C   Begin new page or column
  53.              Return      ^M     0x0D   Reverse to start of line
  54.              Shift Out   ^N     0x0E   No action
  55.              Shift In    ^O     0x0F   No action
  56.              Esc                0x1B   Begin escape sequence
  57.              Esc-7                     Reverse full line feed
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  71.  
  72.  
  73.  
  74.              Esc-8                     Reverse half line feed
  75.              Esc-9                     Forward half line feed
  76.              Esc-D                     Guady header left box text
  77.              Esc-H                     Gaudy header filename area text
  78.              Esc-U                     Gaudy user comment area text
  79.              Esc-F                     Font change sequence
  80.  
  81.      See the SSSSppppeeeecccciiiiaaaallll EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeeessss section below for details on the Esc-D,
  82.      Esc-H, Esc-U and Esc-F sequences.
  83.  
  84.      Control characters and escape sequences not listed above will cause
  85.      _i_m_p_r_i_n_t to issue a warning indicating the offending character and its
  86.      location in the text file. To prevent inadvertently attempting to format
  87.      a binary file, _i_m_p_r_i_n_t will terminate the processing of any file that
  88.      contains more than fifty unrecognized characters unless the ----gggg option has
  89.      been specified (see below). To ensure the proper processing of text files
  90.      the international locale should be established either by setting the LLLLAAAANNNNGGGG
  91.      environment variable prior to running _i_m_p_r_i_n_t.
  92.  
  93.    PPPPoooossssttttSSSSccccrrrriiiipppptttt OOOOuuuuttttppppuuuutttt
  94.      _i_m_p_r_i_n_t produces Level 1 PostScript code formatted in compliance with the
  95.      Adobe Document Structuring Conventions, Version 3.0. The output
  96.      PostScript data sent to the printer is 7-bit clean even when the input
  97.      data is not.
  98.  
  99.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  100.      ----1111        Format text into a single column. This is the default.
  101.  
  102.      ----2222        Format text into two columns. Typically, when using two
  103.                columns, the font size should be reduced to avoid excessive
  104.                line wrapping.
  105.  
  106.      ----BBBB        By default, _i_m_p_r_i_n_t places a simple header at the top of each
  107.                page.  This header consists of the date, time, file pathname
  108.                and page number.  Specifying the ----BBBB switch omits the header.
  109.  
  110.      ----bbbb _h_e_a_d_e_r_T_e_x_t
  111.                Specifies a comment to be placed on the page header. For the
  112.                default header, the _h_e_a_d_e_r_T_e_x_t will replace the file pathname.
  113.                If the ----GGGG option is specified, the _h_e_a_d_e_r_T_e_x_t will be placed
  114.                above the file pathname.
  115.  
  116.      ----cccc        By default, _i_m_p_r_i_n_t wraps text lines that are too long for the
  117.                column. The ----cccc option causes long text lines to be clipped
  118.                rather than wrapped to the next line.
  119.  
  120.      ----dddd _p_r_i_n_t_e_r_N_a_m_e
  121.                If the ----pppp option is not specified, ----dddd specifies a destination
  122.                printer for which the text files are to be formatted and
  123.                printed.  _p_r_i_n_t_e_r_n_a_m_e is the name of the printer as registered
  124.                with the printer spooling system (see _p_r_i_n_t_e_r_s(1M) for
  125.                information on printer installation). The printer may be
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  137.  
  138.  
  139.  
  140.                physically attached to the system or it may be a network
  141.                printer. If a printer has not been specified, the system
  142.                default printer will be used. If the ----pppp option is specified,
  143.                the text files are formatted for the specified printer but are
  144.                sent instead to the specified output file. In this case, if a
  145.                printer has not been specified, the text files are formatted
  146.                assuming a generic environment.
  147.  
  148.      ----FFFF _h_f_o_n_t_N_a_m_e_S_i_z_e
  149.                Specifies the font name and point size to use for the default
  150.                page header.  The default header font is Courier-Bold10. Note
  151.                that this option has no effect when the gaudy header is used.
  152.                See the FFFFoooonnnnttttssss section below for additional information.
  153.  
  154.      ----ffff _f_o_n_t_N_a_m_e_S_i_z_e
  155.                Specifies the font name and point size to use for the body
  156.                text. The default body font is normally Courier10. When rotated
  157.                (----rrrr), two-column (----2222) formatting is specified, the default body
  158.                font becomes Courier7. See the FFFFoooonnnnttttssss section below for
  159.                additional information.
  160.  
  161.      ----GGGG        Provides a more elaborate page decoration and header than the
  162.                default header.  The date, time, file pathname and page number
  163.                are provided along with a space for a user supplied comment
  164.                (see ----bbbb).
  165.  
  166.      ----gggg        _i_m_p_r_i_n_t recognizes plain text characters, a number of common
  167.                control characters and a set of special escape sequences. All
  168.                other characters cause a warning message to be issued
  169.                identifying the character and its location in the input file.
  170.                If more than 50 characters in a file are unrecognized, the
  171.                processing of that file terminates. This prevents inadvertently
  172.                attempting to format a binary file. If a file is to be
  173.                formatted that contains unrecognizable characters, the ----gggg
  174.                option should be specified. This silences all unrecognized
  175.                character warnings and allows an unlimited number of
  176.                unrecognized characters to be processed.
  177.  
  178.      ----hhhh        Specifies that a banner page should not be printed.
  179.  
  180.      ----LLLL _m_a_x_L_i_n_e_s
  181.                Normally, _i_m_p_r_i_n_t places as many lines of text on the page as
  182.                will fit (equivalent to specifying _m_a_x_L_i_n_e_s as 0).  The ----LLLL
  183.                option places a maximum limit on the number of lines placed on
  184.                a page or column.  The number of lines actually produced will
  185.                be either _m_a_x_L_i_n_e_s or the number that can fit on the page
  186.                whichever is less.
  187.  
  188.      ----llll        Specifies a line printer emulation mode. In this mode page
  189.                headers are omitted and 66 lines per page are printed. This
  190.                mode should be specified when printing preformatted _n_r_o_f_f
  191.                manual pages.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  203.  
  204.  
  205.  
  206.      ----mmmm        Causes mail to be sent after the text files have been printed.
  207.                This option has no effect when the ----pppp option is specified.
  208.  
  209.      ----nnnn _n_u_m_C_o_p_i_e_s
  210.                Prints _n_u_m_C_o_p_i_e_s of each page. One copy is the default. When
  211.                the ----pppp option is specified a single copy of the output is
  212.                provided and the ----nnnn option is ignored.
  213.  
  214.      ----oooo _p_r_i_n_t_e_r_O_p_t_i_o_n_s
  215.                Allows printer specific options to be specified. See the _l_p(1)
  216.                manual page for details on this option.
  217.  
  218.      ----pppp _o_u_t_F_i_l_e_n_a_m_e
  219.                Sends the PostScript output to the specified file rather than
  220.                to a printer. If _o_u_t_F_i_l_e_n_a_m_e is specified as '-', the output is
  221.                sent to the standard output. If a printer has been specified,
  222.                the output is formatted for that printer (i.e margins, page
  223.                size, etc.). If a printer has not been specified, a generic
  224.                environment is assumed.
  225.  
  226.      ----qqqq        Normally, _i_m_p_r_i_n_t displays summary information when it has
  227.                completed formatting the text files. The ----qqqq option runs the
  228.                program in silent mode and no summary information is printed.
  229.                Errors and warnings cannot be silenced.
  230.  
  231.      ----RRRR        Specifies non-rotated orientation and is the default. This is
  232.                typically a portrait orientation.
  233.  
  234.      ----rrrr        Specifies that the text columns should be rotated 90 degrees
  235.                counter- clockwise. This is typically a landscape orientation.
  236.  
  237.      ----tttt _b_a_n_n_e_r_T_i_t_l_e
  238.                Specifies a banner page title for the print job.
  239.  
  240.      ----wwww        Causes a message to be sent after the text files have been
  241.                printed. This option has no effect when the ----pppp option is
  242.                specified.
  243.  
  244.    FFFFoooonnnnttttssss
  245.      _i_m_p_r_i_n_t can utilize the fonts found in the directory /_u_s_r/_l_i_b/_D_P_S/_A_F_M.
  246.      The full font name may be specified or one of the font name abbreviations
  247.      listed in the table below may be used.
  248.  
  249.                     FFFFuuuullllllll NNNNaaaammmmeeee                      AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnn
  250.                     ___________________________________________
  251.                     Courier                        C
  252.                     Courier-Bold                   CB
  253.                     Courier-BoldOblique            CBO
  254.                     Courier-Oblique                CO
  255.                     Helvetica                      H
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  269.  
  270.  
  271.  
  272.                     Helvetica-Bold                 HB
  273.                     Helvetica-BoldOblique          HBO
  274.                     Helvetica-Oblique              HO
  275.                     Symbol                         S
  276.                     Times-Bold                     TB
  277.                     Times-BoldItalic               TBI
  278.                     Times-Italic                   TI
  279.                     Times-Roman                    T
  280.                     AvantGarde-Book                AGB
  281.                     AvantGarde-BookOblique         AGBO
  282.                     AvantGarde-Demi                AGD
  283.                     AvantGarde-DemiOblique         AGDO
  284.                     Bookman-Demi                   BD
  285.                     Bookman-DemiItalic             BDI
  286.                     Bookman-Light                  BL
  287.                     Bookman-LightItalic            BLI
  288.                     Helvetica-Narrow               HN
  289.                     Helvetica-Narrow-Bold          HNB
  290.                     Helvetica-Narrow-BoldOblique   HNBO
  291.                     Helvetica-Narrow-Oblique       HNO
  292.                     NewCenturySchlbk-Bold          NCSB
  293.                     NewCenturySchlbk-BoldItalic    NCSBI
  294.                     NewCenturySchlbk-Italic        NCSI
  295.                     NewCenturySchlbk-Roman         NCSR
  296.                     Palatino-Bold                  PB
  297.                     Palatino-BoldItalic            PBI
  298.                     Palatino-Italic                PI
  299.                     Palatino-Roman                 PR
  300.                     ZapfChancery-MediumItalic      ZCMI
  301.                     ZapfDingbats                   ZD
  302.  
  303.      If a font is specified that is not found in the font directory, Courier
  304.      will be substituted. Note that a fixed-width font such as Courier should
  305.      be used when printing tabular material and preformatted manual pages.
  306.  
  307.    SSSSppppeeeecccciiiiaaaallll EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeeessss
  308.      _i_m_p_r_i_n_t recognizes a number of special escape sequences. These sequences
  309.      can be embedded in a text file to change header text and switch fonts
  310.      during processing of  the file.  The escape sequences are compatible with
  311.      those used by the _e_n_s_c_r_i_p_t program from the Adobe TranScript product. The
  312.      sequences are:
  313.  
  314.             EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeee      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  315.             __________________________________________________________
  316.             Esc-D(_t_o_p)(_b_o_t_t_o_m)   Gaudy header left box text
  317.             Esc-H_h_e_a_d_e_r_T_e_x_t      Gaudy header filename area text
  318.             Esc-U_c_o_m_m_e_n_t_T_e_x_t     Gaudy user comment area text
  319.             Esc-F_c               Font change sequence (see _t_e_x_t_2_p_s(1))
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  335.  
  336.  
  337.  
  338. EXAMPLES
  339.      1.   Printing a preformatted manual page to the default printer:
  340.  
  341.           pcat csh.z | imprint -l
  342.  
  343.  
  344.      2.   Printing a file to the printer 'dj' in two column, landscape mode
  345.           with a gaudy header:
  346.  
  347.           imprint -d dj -2rG /etc/passwd
  348.  
  349.  
  350. NNNNOOOOTTTTEEEESSSS
  351.      1.   the _i_m_p_r_i_n_t program runs the _t_e_x_t_2_p_s program to perform the work for
  352.           formatting the text files and the _l_p program to print them. Refer to
  353.           the manual pages for these programs for detailed information on
  354.           formatting and printing issues.
  355.  
  356.      2.   The PostScript output produced by _i_m_p_r_i_n_t conforms to the Adobe
  357.           PostScript Document Structuring Conventions Version 3.0 as specified
  358.           in Appendix G of the "PostScript Language Reference Manual", 2nd
  359.           edition.
  360.  
  361.      3.   If _i_m_p_r_i_n_t is given an unrecognized or incomplete command line
  362.           option switch, it will print a warning message to the standard
  363.           error, ignore the option and continue processing.
  364.  
  365.      4.   If a file is specified on the command line, _i_m_p_r_i_n_t will not read
  366.           its stdin for text files.
  367.  
  368.      5.   _i_m_p_r_i_n_t can only process a single file when reading from standard
  369.           input.
  370.  
  371.      6.   Use a of proportional spaced font or dynamically changing fonts when
  372.           formatting manual pages can cause misformatting of tables.
  373.  
  374. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  375.      If the environment variable IIIIMMMMPPPPRRRRIIIINNNNTTTT is set, _i_m_p_r_i_n_t will treat the
  376.      contents of this variable as command line options. For example, if
  377.      IIIIMMMMPPPPRRRRIIIINNNNTTTT has been set to '-2rG', _i_m_p_r_i_n_t will print in two-column, rotated
  378.      mode with a gaudy header whenever it is invoked. Options specified on the
  379.      command line override environment variable options.
  380.  
  381. FFFFIIIILLLLEEEESSSS
  382.      /usr/sbin/imprint         Program file
  383.      /usr/lib/print/text2ps    Text formatting filter
  384.      /usr/bin/lp               Printing program
  385.  
  386. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  387.      text2ps(1), lp(1)
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.